home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
Composite.z
/
Composite
Wrap
Text File
|
1998-10-30
|
11KB
|
199 lines
CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
NNNNAAAAMMMMEEEE
CCCCoooommmmppppoooossssiiiitttteeee - The Composite widget class
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Composite widgets are intended to be containers for other
widgets and can have an arbitrary number of children. Their
responsibilities (implemented either directly by the widget
class or indirectly by Intrinsics functions) include:
+o Overall management of children from creation to
destruction.
+o Destruction of descendants when the composite widget
is destroyed.
+o Physical arrangement (geometry management) of a
displayable subset of managed children.
+o Mapping and unmapping of a subset of the managed
children. Instances of composite widgets need to
specify the order in which their children are kept.
For example, an application may want a set of command
buttons in some logical order grouped by function, and
it may want buttons that represent filenames to be
kept in alphabetical order.
CCCCllllaaaasssssssseeeessss
Composite inherits behavior and resources from CCCCoooorrrreeee.
The class pointer is _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s.
The class name is CCCCoooommmmppppoooossssiiiitttteeee.
NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss
The following table defines a set of widget resources used
by the programmer to specify data. The programmer can also
set the resource values for the inherited classes to set
attributes for this widget. To reference a resource by name
or by class in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC
prefix and use the remaining letters. To specify one of the
defined values for a resource in a ....XXXXddddeeeeffffaaaauuuullllttttssss file, remove
the XXXXmmmm prefix and use the remaining letters (in either
lowercase or uppercase, but include any underscores between
words). The codes in the access column indicate if the
given resource can be set at creation time (C), set by using
XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (S), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (G), or is
Page 1 (printed 10/24/98)
CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
not applicable (N/A).
CCCCoooommmmppppoooossssiiiitttteeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss
XmNchildren XmCReadOnly WidgetList NULL G
XmNinsertPosition XmCInsertPosition XtOrderProc NULL CSG
XmNnumChildren XmCReadOnly Cardinal 0 G
XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn
A read-only list of the children of the widget.
XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn
Points to the _X_t_O_r_d_e_r_P_r_o_c function described
below.
XXXXmmmmNNNNnnnnuuuummmmCCCChhhhiiiillllddddrrrreeeennnn
A read-only resource specifying the length of the
list of children in XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn.
The following procedure pointer in a composite widget
instance is of type _X_t_O_r_d_e_r_P_r_o_c:
Cardinal (* XtOrderProc) (Widget _w);
_w Specifies the widget.
Composite widgets that allow clients to order their children
(usually homogeneous boxes) can call their widget instance's
XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnnprocedure from the class's iiiinnnnsssseeeerrrrtttt____cccchhhhiiiilllldddd
procedure to determine where a new child should go in its
children array. Thus, a client of a composite class can
apply different sorting criteria to widget instances of the
class, passing in a different XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnnprocedure
when it creates each composite widget instance.
The return value of the XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnnprocedure indicates
how many children should go before the widget. A value of 0
(zero) indicates that the widget should go before all other
children; returning the value of _X_m_N_u_m_C_h_i_l_d_r_e_nindicates that
it should go after all other children. By default, unless a
subclass or an application provides an XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn
procedure, each child is inserted at the end of the
XXXXmmmmNNNNcccchhhhiiiillllddddrrrreeeennnn list. The XXXXmmmmNNNNiiiinnnnsssseeeerrrrttttPPPPoooossssiiiittttiiiioooonnnn procedure can be
overridden by a specific composite widget's resource list or
by the argument list provided when the composite widget is
created.
IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss
Composite inherits behavior and resources from the
superclass described in the following table. For a complete
description of each resource, refer to the reference page
for that superclass.
Page 2 (printed 10/24/98)
CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV CCCCoooommmmppppoooossssiiiitttteeee((((lllliiiibbbbrrrraaaarrrryyyy ccccaaaallllllll))))
CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt
NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss
XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG
XmNancestorSensitive XmCSensitive Boolean dynamic G
XmNbackground XmCBackground Pixel dynamic CSG
XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG
XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG
XmNborderWidth XmCBorderWidth Dimension 1 CSG
XmNcolormap XmCColormap Colormap dynamic CG
XmNdepth XmCDepth int dynamic CG
XmNdestroyCallback XmCCallback XtCallbackList NULL C
XmNheight XmCHeight Dimension dynamic CSG
XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C
XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG
XmNscreen XmCScreen Screen * dynamic CG
XmNsensitive XmCSensitive Boolean True CSG
XmNtranslations XmCTranslations XtTranslations dynamic CSG
XmNwidth XmCWidth Dimension dynamic CSG
XmNx XmCPosition Position 0 CSG
XmNy XmCPosition Position 0 CSG
TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss
There are no translations for Composite.
RRRREEEELLLLAAAATTTTEEEEDDDD
CCCCoooorrrreeee(3).
Page 3 (printed 10/24/98)